home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / anwender / astrolog / timezone / timezone.doc next >
Encoding:
Text File  |  1995-11-25  |  4.1 KB  |  104 lines
  1.                              TimeZone 1.0 (7 septembre 1995)
  2.  
  3.                                                           Abel PHILIPPE
  4.  
  5. Ce programme en CPX permet de gérer les fuseaux horaires et le décalage entre
  6. l'heure d'été et l'heure d'hiver. Grâce à lui, Astrolog (ou tout autre
  7. programme) peut retrouver, à partir de l'horloge de la machine, l'heure
  8. de référence internationnal, à savoir l'heure GMT.
  9.  
  10. Installation :
  11. ------------
  12. Copiez le fichier TIMEZONE.CPX dans le dossier CPX de votre partition
  13. de BOOT. Si vous ne l'avez pas encore, copier le fichier XCONTROL.ACC
  14. à la racine de votre partition de BOOT.
  15. Si vous utilisez un Atari ST/F ou un Méga ST/F (et seulement ces modèles, et
  16. non ceux qui sont sortis à partir du STE), copiez le fichier ACOOKIE.PRG
  17. dans le dossier AUTO de votre partition. Celui-ci se charge de créer un
  18. 'Cookie Jar' en mémoire et d'installer une routine de reset spéciale.
  19.  
  20. Utilisation :
  21. -----------
  22. En France, nous avons une heure d'avance sur l'heure GMT en hiver, et deux
  23. en été. TIMEZONE.CPX doit donc être réglé comme ceci :
  24.  
  25. - cliquez sur le bouton 'Time zone' : un menu s'affiche. Il faut choisir,
  26. avec les flèches, l'item 'Central European Time  -1h  '.
  27.  
  28. - sélectionnez le bouton 'Daylight Time' en été, et déselectionnez-le en
  29. hiver.
  30.  
  31. - à droite de ce bouton, entrez '-1h00' dans le champ éditable. Il s'agit
  32. du décalage entre l'heure d'été et d'hiver.
  33.  
  34. - Cliquez sur 'Save' pour sauver vos réglages.
  35.  
  36. Lors du passage de l'heure d'été à l'heure d'hiver ou réciproquement, vous
  37. n'aurez plus qu'à cliquer sur le bouton 'Daylight Time', et à règler l'horloge
  38. du système. (Je sais : ça serait bien que TimeZone permette de règler
  39. l'horloge lors du changement d'heure ! Peut-être dans la version 1.1).
  40.  
  41. Note aux développeurs :
  42. ---------------------
  43. TIMEZONE.CPX ajoute un Cookie dont voici la description :
  44.  
  45.     identificateur : 'ZONE'
  46.     
  47.     valeur :  je considère cette valeur comme celle de 2 entiers i et j :
  48.                 le mot de poids fort pour i, et faible pour j.
  49.  
  50. Explication :
  51.     i contient le nombre de minutes qu'il faut soustraire à l'heure du
  52.     système pour retrouver l'heure GMT (l'heure Temps Universel en fait mais
  53.     bon ...)
  54.     
  55.     j contient le nombre de minutes qu'il faut soustraire à l'heure du
  56.     système pour tenir compte de l'heure d'été. Ainsi, en France, j doit
  57.     contenir -60 l'été, et 0 l'hiver.
  58.  
  59. J'ai écrit ce programme car j'en ai eu besoin pour utiliser la fonction
  60. time() de Pure C. Celle-ci retourne le nombre de seconde écoulée depuis
  61. le 1 janvier 1970 à 0h00 GMT. Elle se base pour ses calculs sur
  62. deux variables globales qui sont timezone et daylight. D'après mes essais
  63. (et l'aide en ligne de Pure C), timezone doit contenir le nombre de seconde
  64. à soustraire à l'heure locale pour trouver l'heure GMT, et daylight doit
  65. contenir 1 si il faut soustraire une heure supplémentaire correspondant à
  66. l'heure d'été (daylight). Par défaut, timezone contient 3600 et daylight 0
  67. (réglage pour l'Allemagne ?)
  68. Ces deux variables agissent sur time() et gmtime() mais pas sur localtime()
  69. (C'est assez logique).
  70.  
  71. Voici donc comment utiliser la valeur du cookie :
  72.  
  73.         timezone=-i*60;
  74.         daylight=-j/60;
  75.  
  76. J'espère que cela marchera dans tous les cas. Cependant, il semble que dans
  77. certain pays, le décalage été/hiver puisse être différent d'une heure.
  78. Je ne sais pas comment réagirait le système, puisque daylight ne peut
  79. recevoir que des entiers. De toute façon, il doit être possible de s'en
  80. sortir en donnant une valeur adéquate à timezone.
  81.  
  82. Diffusion :
  83. ---------
  84. TimeZone 1.0 est un logiciel freeware. Vous pouvez le diffusez librement
  85. autour de vous.
  86.  
  87. Remerciements :
  88. -------------
  89. Je salue au passage Jacques Caron de ST Magasine, dont j'ai utilisé
  90. les routines de gestion des cookies (numéro 52), ainsi que Pascal Craponne,
  91. du même ST Magazine, pour l'initiation à la programmation des CPX parue dans
  92. les numéros 54,55 et 57.
  93.  
  94. Pour me contacter :
  95. -----------------
  96.  
  97.               abel@mathp7.jussieu.fr
  98.  
  99.             ou   BIBOUL en 3615 STMAG et 3615 RTEL
  100.  
  101.             ou   Abel PHILIPPE
  102.                   16 rue St Ferdinand
  103.                   75017 PARIS
  104.